Crate aws_config

source ·
Expand description

aws-config provides implementations of region and credential resolution.

These implementations can be used either via the default chain implementation from_env/ConfigLoader or ad-hoc individual credential and region providers.

ConfigLoader can combine different configuration sources into an AWS shared-config: SdkConfig. SdkConfig can be used configure an AWS service client.

Examples

Load default SDK configuration:

let config = aws_config::load_from_env().await;
let client = aws_sdk_dynamodb::Client::new(&config);

Load SDK configuration with a region override:

let region_provider = RegionProviderChain::default_provider().or_else("us-east-1");
let config = aws_config::from_env().region(region_provider).load().await;
let client = aws_sdk_dynamodb::Client::new(&config);

Override configuration after construction of SdkConfig:

let sdk_config = aws_config::load_from_env().await;
let custom_credentials_provider = custom_provider(&sdk_config);
let dynamo_config = aws_sdk_dynamodb::config::Builder::from(&sdk_config)
  .credentials_provider(custom_credentials_provider)
  .build();
let client = aws_sdk_dynamodb::Client::from_conf(dynamo_config);

Modules

  • connector
    Functionality related to creating new HTTP Connectors
  • credential_process
    Credentials Provider for external process
  • default_provider
    Providers that implement the default AWS provider chain
  • ecs
    Ecs Credentials Provider
  • endpoint
    Code for resolving an endpoint (URI) that a request should be sent to
  • environment
    Providers that load configuration from environment variables
  • imds
    IMDSv2 Client, credential, and region provider
  • meta
    Meta-providers that augment existing providers with new behavior
  • profile
    Load configuration from AWS Profiles
  • provider_config
    Configuration Options for Credential Providers
  • retry
    Retry configuration
  • sso
    SSO Credentials Provider
  • sts
    Credential provider augmentation through the AWS Security Token Service (STS).
  • timeout
    Timeout configuration
  • web_identity_token
    Load Credentials from Web Identity Tokens

Structs

  • AppName
    App name that can be configured with an AWS SDK client to become part of the user agent string.
  • ConfigLoader
    Load default sources for all configuration with override support Load a cross-service SdkConfig from the environment
  • InvalidAppName
    Error for when an app name doesn’t meet character requirements.
  • SdkConfig
    AWS Shared Configuration

Functions

  • from_env
    Create an environment loader for AWS Configuration
  • load_from_env
    Load a default configuration from the environment